home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / demo / igp8_102.zip / README.1ST < prev    next >
Text File  |  1994-06-23  |  5KB  |  97 lines
  1. ////////////////////////////////////////////////////////////////////////////////////
  2. // Internet Global Phone Project
  3. // README.1ST : Important General Information Regarding the Distribution
  4. ////////////////////////////////////////////////////////////////////////////////////
  5. // Copyright (c) 1993-1994    microWonders Inc.  All rights reserved.
  6. //                                                                         
  7. // AN OPEN INVITION TO BUILD UPON AND CONTRIBUTE TO THE PUBLIC TECHNOLOGY POOL:
  8. // You are encouraged to redistribute, and build upon the technologies presented 
  9. // in this source module and the accompanying article in Dr. Dobb's Journal provided 
  10. // all the conditions listed in the MUSTREAD.TXT file, included with this 
  11. // distribution, are met.
  12. ////////////////////////////////////////////////////////////////////////////////////
  13.  
  14. Please make sure you have read MUSTREAD.TXT before continuing with the distribution.
  15.  
  16. EXTRACTING FILES
  17.  
  18. NOTE: Use 'pkunzip -d' to unzip in order to preserve the directories 
  19.       structure.
  20.  
  21. SYNOPSIS
  22.  
  23. The Internet Global Phone project is a technology demonstration project 
  24. providing a code platform for two way real-time voice exchange over the 
  25. Internet. The details of the project are documented in an accompanying article in 
  26. Dr.Dobb's Journal in 1994.
  27.               
  28. SYSTEM REQUIREMENTS
  29.  
  30. To compile IGP, you will need Microsoft Visual C++ 1.5, and MFC 2.5.
  31. You will need all the source code provided, together with SOCKLIB.LIB and 
  32. GSM.LIB provided.  All source code must be compiled using the Medium memory
  33. model.  You will also need WINSOCK.LIB and WINSOCK.H from your WINSOCK 
  34. supplier. The complete original GSM source distribution is included. Please
  35. make sure you include them if you will be re-distributing source code.
  36.                                                          
  37. To run IGP, you will need an Internet or TCP/IP connection (either direct
  38. or dial in), a system with a Windows supported PC sound board, a working 
  39. microphone and speaker.  A machine of 33 Mhz 486 or higher is recommended
  40. for best performance in compression/decompression.  The IGP software has
  41. been tested mainly on a 22/486, but also on a 20/386.  The 386 gave only
  42. marginal performance, voice was extremely chunky.
  43.  
  44. The 16 bit GSM compression algorithm port has some artifacts.  On a high fidelity
  45. setup, you will hear some 'tin-like' popping sound distortion.  Interestingly
  46. enough, if you use the cheapest speaker you can find, they 'naturally' filter
  47. those annoying pops out. Therefore, USE CHEAP SPEAKERS!
  48.  
  49. If you have a 16 bit audio card, try re-compiling with the 16 bit enable flag, 
  50. you can obtain better dynamics in the transmitted audio.  Thanks to GSM, it is
  51. okay to record in 16 bit even if the other end (playback) only does 8 bits sound.
  52.                                                            
  53. OPERATIONS
  54.  
  55. Make sure you have WSNETWRK.DLL in a search path.  Run mphone.exe.  
  56.  
  57. The user interface is extremely simple.  There are only 3 buttons.
  58.  
  59. The first button will allow you to specify who you want to talk to.  Click 
  60. this now and enter your own IP address (if it is not already detected).
  61.  
  62. The RED button is used to start recording/compression.  After you press this
  63. button, you can speak into the microphone.  The third button, with the yellow
  64. lightning bolt, is the transmission button.  When you finish recording, simply
  65. press this button to send the voice message to your receipient.  The buttons
  66. will remain in a locked state until compression and transmission are completed.
  67.  
  68. The status window will provide status report from the various conceptual 'threads':
  69.     The Listener Thread.
  70.     The Client Thread.
  71.     The Server Thread.                      
  72.     
  73. You can attempt a quick test of operation by 'speaking to yourself'.  Enter your
  74. own IP address, press the record button and speak into the mike, press the 
  75. lightning bolt to send.  Notice the messages on the status window.
  76.  
  77. TESTING
  78.  
  79. As mentioned previously, IGP has been tested on a 486/33, 486/66, and 386/20.  
  80. Using both slip connection over 14,400 bds modem and direct ethernet link.  
  81. It has been tested with two very popular Winsock stacks:  Trumpet Winsock 
  82. over slip, and Microsoft 32 bit TCP/IP VxD Beta Final version (Wolverine).
  83.  
  84. MESSAGE TO PROGRAMMERS
  85.  
  86. This project is meant to serve as a demonstration and a foundation.
  87. By all means, please improve on the code, the user interface, etc. Make some
  88. new, cool phones, and let the world in on the action.  As a courtesy, 
  89. please send a message to me at lsing@hookup.net announcing your new creations.
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.               
  97.